home *** CD-ROM | disk | FTP | other *** search
/ Risc World 5 / Risc World 5.iso / SOFTWARE / Issue6 / VICE / VICE.ZIP / !ViceRsrc / !Help < prev    next >
Text File  |  2005-01-24  |  35KB  |  756 lines
  1. Vice 1.16 for RISC OS
  2. =====================
  3.  
  4.  
  5.  
  6.  
  7. For general information see the Vice documentation. This file only deals with
  8. differences / specialities in the RISC OS version.
  9.  
  10.  
  11.  
  12. RISC OS NEWS since 1.15
  13. =======================
  14.  
  15. Only two things, really (apart from minor, strictly internal issues):
  16. 1) Fixed savebox handling bug (return and click on OK button didn't work in
  17.    all cases the savebox was used)
  18. 2) Built this release with GCC-3.4.4
  19.  
  20.  
  21.  
  22. RISC OS NEWS since 1.14
  23. =======================
  24.  
  25. Nothing. I was hoping to compile this version with the GCC-3.41 prerelease,
  26. but the resulting VICE binaries didn't work, so it's GCC-3.3 again.
  27.  
  28.  
  29.  
  30. RISC OS NEWS since 1.13
  31. =======================
  32.  
  33. This time there were lots of internal changes, one side-effect of which is
  34. that the VICE RISC OS binaries can now also be built with the GCCSDK
  35. crosscompiler on a Unix machine with the standard tools used for building
  36. VICE there (including the auto* stuff). A configure script to use for this
  37. will be in the ViceROKit.zip archive for this version (available from my
  38. homepage). This release was built with GCC 3.3 on a Linux machine, for
  39. instance, as my tests so far showed the code to be stable and a little
  40. faster than 2.95.4 builds. Should unforeseen problems arise after all,
  41. I'll make a 2nd release based on 2.95.4.
  42. Playing around with lots of different compiler versions lately also helped
  43. me find two ancient Wimplib bugs, so this release should have improved
  44. stability compared to older versions. Important news in this version:
  45.  
  46. - Since VICE supports 4 true drive devices now, memory requirements
  47.   have gone up another notch, so the memory footprint is now between 9MB
  48.   and 13.5MB, depending on the emulator (except for VSID, which is still
  49.   around 6MB).
  50.  
  51. - C64 and C128 support the 1351 mouse emulation now. Using the mouse in
  52.   WIMP mode is a bit tricky, since you'll end up with two pointers and
  53.   the emulated one will not move unless the real one is within the
  54.   emulator window, also it's hard to sync the speeds of the two. If you
  55.   want to use the mouse without hassles, go to fullscreen mode.
  56.  
  57.  
  58.  
  59. RISC OS NEWS since 1.12
  60. =======================
  61.  
  62. No new features this time either, just kept the RISC OS port in sync. There
  63. is one important change regarding the DigitalRenderer module, however.
  64. Formerly, this module was distributed along with Vice in !ViceRsrc. Since
  65. other projects started using it recently (e.g. various SDL game ports),
  66. this is no longer sensible, so now the emulators try to load the the
  67. module from System:Modules. For you as a user, this means you'll have
  68. to download the module (e.g. from my homepage at the bottom of the file)
  69. and copy the module from there to <System$Dir>.310.Modules.
  70.  
  71.  
  72.  
  73. RISC OS NEWS since 1.11
  74. =======================
  75.  
  76. I added no new features and just kept the RISC OS specific files in sync
  77. with the main distribution. However, there were many internal changes to
  78. my Wimplib and the support modules (DigitalRenderer and BPlot) that make
  79. this release of Vice 32bit compatible. From what I've heard, an Iyonix can
  80. sustain 100% emulation speed even under tricky conditions, which would be
  81. good news for a change. Note you'll need the 32bit SCL installed on your
  82. system to run this release.
  83.  
  84.  
  85.  
  86. RISC OS NEWS since 1.9
  87. ======================
  88.  
  89. There have been mostly internal changes between those releases, as there
  90. haven't been any new features in the emulation core and I don't see the
  91. need to change the way the existing features are handled. Internal changes
  92. mostly deal with updates in my WimpLib (Small-footprint LGPL C/C++ library
  93. providing the interface to RISC OS, also available from my Software pages),
  94. e.g. better sprite handling, a standard menu for text windows (allowing you
  95. to e.g. save or edit text). Other changes include support for chip-specific
  96. video caches.
  97. Also note that my email address changed to zarquon@t-online.de since I
  98. successfully finished my PhD thesis and consequently quit FORWISS last may.
  99.  
  100.  
  101.  
  102. RISC OS NEWS since 1.8
  103. ======================
  104.  
  105. - (Internal change: switched to GCC 2.95.4)
  106.  
  107. - Stereo SID option. Basically the driver for this already worked in 1.8,
  108.   I just hadn't tested it before the release. Note that if you use the
  109.   StereoSID Player you have to run Vice in NTSC mode!
  110.  
  111. - Due to the many new options introduced with PAL emulation, there is now
  112.   a separate video configuration window.
  113.  
  114. - In order to support PAL emulation, the low-level interface in Vice has
  115.   changed. In the old versions, a bitmap with the correct colours for the
  116.   current mode was created, whereas in the new version, the bitmap always
  117.   has the C64 colours. That means I had to move to (slower) OS_SpriteOp plots
  118.   rather than my old BPlot module. There are some cases where the BPlot
  119.   module can still be used: for non-PAL emulation canvases, in case the screen
  120.   depth is more than 8bpp or in full screen mode if the screen palette is set
  121.   (see video config window "Set Palette"). If you select "Use BPlot" in the
  122.   video config window, you can still use the BPlot module in these cases,
  123.   otherwise Vice will always use OS_SpriteOp.
  124.   In case you own a ViewFinder graphics card, Vice will probably run much
  125.   better if you always switch OFF "Use BPlot".
  126.  
  127. - PAL emulation: this probably requires some additional words, in particular
  128.   regarding scaling. PAL emulation really needs a 2x screen to be fully
  129.   operational; you can achieve this by ticking the PAL double box in the
  130.   video config window. Note that the resulting bitmap is NOT just the 1x
  131.   bitmap scaled up, which is also the reason why I handled scaling the way
  132.   I did: the toggle icon on the emu pane does the ``soft'' scaling, i.e.
  133.   it merely allows plotting the bitmap at twice its normal size. PAL double
  134.   allows calculating a bitmap at twice the size, and you can use the soft
  135.   scaling in addition, if you want to. That system may seem a bit confusing
  136.   at first (try juggling 3 scaling factors in your coordinate transformations
  137.   for confusing, buddy: eigen factors, soft scaling, PAL double), but if you
  138.   bear in mind that the toggle icon on the pane just displays the same thing
  139.   larger whereas PAL double does more, it is logical in a way.
  140.   Regarding the depth used for PAL emulation, you can select five options
  141.   here:
  142.   - off (disables it)
  143.   - auto (uses the depth of the current screen mode, but at least 8bpp)
  144.   - 8/16/32: use this depth regardless of the current screen mode
  145.   8bpp PAL emu has to compromise, so you should use either 16bpp or 32bpp
  146.   modes if you want the real thing -- and use a screen mode of the same depth
  147.   for display.
  148.   A word of warning on PAL emu, though: it's very expensive, especially in
  149.   double size mode, plus the high colour depth required and the additional
  150.   frame buffer really choke the life out of the pitifully little bandwidth
  151.   we have available on RISC OS. Unless a miracle happens and someone releases
  152.   new RISC OS hardware with a fast bus and about 1GHz of processing power,
  153.   PAL emulation is unusable for anything but making nice screenshots on
  154.   RISC OS, I'm afraid.
  155.  
  156. - In order to save some trouble there are different screen modes possible
  157.   for full screen emulation in normal, PAL and double size PAL mode
  158.   possible (see video config window).
  159.   
  160.  
  161.  
  162.  
  163. RISC OS NEWS since 1.7
  164. ======================
  165.  
  166. No visible ones, since I was very busy towards the end of last year and could
  167. just keep the port in sync. The new stuff like PAL emulation and GUI (plus
  168. testing) of stereo SIDs will follow in the next version.
  169.  
  170.  
  171.  
  172. RISC OS NEWS since 1.6
  173. ======================
  174.  
  175. - (Internal change: switched from GCC 2.7.2 to GCC 2.95.2)
  176. - (Internal change: DigitalRenderer now voice generator based or 16bit enabled)
  177. - Added support for GZIP-compressed image files (file type &f89 or /gz extension)
  178. - Clear/Load/Save fliplist files. Clear and save is obvious, using the fliplist
  179.   menu (note that you can't save an _empty_ fliplist). You can load a fliplist
  180.   by dragging the fliplist file (must have filetype Text) to the emulation pane;
  181.   the first image in the fliplist will be attached to drive 8 automatically.
  182. - Provided interactive help because the emulators have become rather complex and
  183.   many people will probably not be aware of what the buttons can do.
  184. - Made drive types 2040, 3040 and 4040 available from the drive config window.
  185. - Fixed cartridge detaching by selecting type None (this works now).
  186. - Finally fixed Auto refresh speed and made it the default for all emulators.
  187.   That means that the number of frames are reduced automatically down to a
  188.   minimum number if the emulator can't run at 100% and redraw every frame.
  189.   That means that games like Delta and Armalyte are pretty playable (if a bit
  190.   jittery) now. You can configure the maximum number of skipped frames in the
  191.   system configuration window. The default is 5 and choosing larger values
  192.   doesn't improve emulation speed much more, but the display gets very jerky.
  193.   You should always use odd values for the maximum (some games and demos have
  194.   things flashing every other frame which you won't see otherwise).
  195. - Added a log window with the log messages. People who know Vice on Unix will
  196.   be familiar with the log messages, others may be somewhat surprised at all
  197.   the stuff that's logged. The log messages help diagnosing problems, also for
  198.   normal users; for instance if the log message is ``VDriveCommand: ERR = 30,
  199.   SYNTAX ERROR ...'' you tried to use high-level drive emulation on a program
  200.   that requires true drive emulation turned on. The maximum number of lines
  201.   kept in memory is limited to 1024, so you don't have to worry about memory
  202.   consumption exploding during long sessions with Vice. In the unlikely case of
  203.   the new log window causing problems or if you want to disable them for some
  204.   other reason, you just have to add ``-logfile null:'' to the last line of
  205.   the emulated machine's !Run file (without the `` / '', of course). I'm sorry,
  206.   but logging is determined too early in the program to allow for GUI widgets
  207.   to configure them.
  208. - Automatically suspend emulation in lots of places like attaching images etc.
  209.   to avoid these operations screwing up emulation (especially sound when the
  210.   image is on CDROM).
  211. - Extended the DigitalRenderer module to support 16bit sound as provided on
  212.   RO 3.5 and newer; as a matter of fact the DigitalRenderer module saw a major
  213.   overhaul in this release, see !ViceRsrc.DocDRender if you're interested in
  214.   more details and/or want to use sound in an application of your own. By default
  215.   16bit sound is _off_ in order to minimize compatibility issues, but if you have
  216.   16bit sound hardware I recommend that you enable it because it sounds much
  217.   better and causes less problems with the painfully exact sync reSID needs,
  218.   although both of these issues are probably just consequences of emulating the
  219.   old 8bit system on the new 16bit one. You can enable it from the sound config
  220.   window. In case you experience problems with 16bit sound, please let me know.
  221. - Image contents work with normal directories too. Since we already have the
  222.   filer you might ask: what for? And verily I tell you: because it allows you
  223.   to autostart PRG files without having to type LOAD statements by double-
  224.   clicking. You open an image contents viewer by holding down shift while
  225.   dragging the directory to one of the drive icons.
  226. - Double-clicking on the title in an image contents window does LOAD"*",8,1
  227.   (except for normal directories).
  228. - The semantics of dragging PRG-files to the emu window have changed. Now the
  229.   PRGs are autostarted on all emulators. If you hold down shift when releasing
  230.   the drag, on the C64 the file is only loaded (this is the old behaviour).
  231. - Added keyboard-shortcuts for snapshots and screenshots. Note that these can
  232.   only be used after a valid shot was made using the normal GUI elements, otherwise
  233.   you'll get an error. The main reason for these keyboard shortcuts was to be
  234.   able to handle snapshots and screenshots in full screen mode. The keys are:
  235.   Print (save screenshot), ^F9 (save snapshot), ^F10 (load snapshot).
  236.  
  237.  
  238.  
  239. RISC OS NEWS since 1.5
  240. ======================
  241.  
  242. - Added read-only options for all drives (marked as RO in the drive configuration
  243.   window to keep space requirements low).
  244. - Dag Lem modified his reSID engine so the actual engine is run fewer times,
  245.   resulting in a substantial speedup. In addition I rewrote some remaining
  246.   sound-related FP code to fixpoint, resulting in another big speedup. reSID
  247.   is now usable under RISC OS :-)
  248. - Added VSID mode. The VSID player uses the C64-binary in a special mode and
  249.   allows playing SID files without burdening the emulation with video and
  250.   drive issues, therefore the !Vice64 binary must have been seen by the filer
  251.   for VSID to operate. If you have a SA RPC do use reSID since it sounds much
  252.   better.
  253. - Improved speed limit code: NTSC works now, plus disturbances have less effect.
  254. - Added some functionality to wimplib. Now the monitor window is limited to
  255.   around 4096 lines to save memory when you're doing long sessions (like an
  256.   xterm does).
  257. - Some minor changes to the DigitalRenderer module for improved stability.
  258.  
  259.  
  260.  
  261. RISC OS NEWS since 1.4
  262. ======================
  263.  
  264. After a long time of just keeping the source in sync with the other ports I
  265. added some new stuff for 1.5 again. I've been working on WimpLib a lot lately
  266. and added a text window that can be used for both displaying text and as a
  267. command line widget so I could finally integrate the monitor better. In order
  268. to compile Vice you now need WimpLib 0.10 or newer.
  269.  
  270. - Replaced the monitor with a (multitasking) text widget. That means opening
  271.   the monitor does no longer freeze the entire desktop, apart from that you
  272.   get scrollbars and all the other niceties of a real window. While the monitor
  273.   is open the emulator is paused and you can't unpause it except for closing
  274.   the monitor again. This makes sure that there can be no reentrancy into the
  275.   monitor and is in fact the only system which was totally compatible with
  276.   Vice's internal use of the monitor (e.g. opening the monitor after a JAM code).
  277.   But nothing is modal, and that's the main issue here.
  278.   I know, most people won't ever use the monitor, but this is something I've
  279.   wanted to add for ages. Note that the monitor window can't be closed while
  280.   the monitor is outputting stuff, but the close request will be recorded and
  281.   executed as soon as the output is finished.
  282. - The other text windows (license, warranty, contrib) are now displayed with
  283.   the new WimpLib class as well and can be open concurrently (also you can
  284.   now navigate through them using the keyboard, but they're read-only).
  285. - Split drive window into (disk) drives and tape.
  286. - Resetting the emulator with double sized window now works correctly.
  287. - Fixed auto-attach of images on startup (interface must have changed somewhere
  288.   on the line).
  289. - Added FlipList support. This allows you to keep certain disk images in a
  290.   sort of hotlist for quick access. The Fliplist menu is accessible from the
  291.   emulation window menu and allows you to add the current disk image to the
  292.   fliplist, remove the current disk image from the fliplist, attach the next
  293.   and previous image in the fliplist. There's also a submenu that allows
  294.   direct access to all images in the fliplist; since this menu is also mirrored
  295.   somewhere there's also a detach entry to detach the currently active image.
  296.   You can also use PageUp / PageDown to walk through the fliplist which is
  297.   very handy for full screen mode.
  298.   Note that the fliplist is only available for drive 8!
  299. - The menu containing all the fliplist images is now also available by clicking
  300.   menu over the drive 8 icons on the emu pane.
  301. - The currently selected drive image is now displayed in the emulation window
  302.   title.
  303. - Added a window to create a new, empty disc image. It's accessible from the
  304.   icon bar menu.
  305. - Thanks to a wimplib extension almost all menus are indirected now. That means
  306.   that the menu text can become considerably longer than the 12 characters
  307.   possible so far. ATM I set the limit to 32 which should be fine for now.
  308. - Added a new sound device ``VIDC Sync'' (for synchronous VIDC). The old code
  309.   was running the sound as an asynchronous thread which has the advantage of
  310.   having very good latency characteristics, but unfortunately doesn't integrate
  311.   well with the way Vice handles complex sounds (e.g. samples) and issues like
  312.   oversampling internally. The synchronous device can handle these; the only
  313.   problem is that emulating sound samples as exact as Vice does, the performance
  314.   usually drops to 50% on my StrongARM RiscPC, so we'll have to wait for much
  315.   faster machines until it becomes really worthwhile...
  316.   In the meantime: as long as you're using ``simple'' sound, stick with the old
  317.   asynchronous device, if you want to listen to samples or use oversampling, use
  318.   the new synchronous one.
  319.   Note this also required a big update of the DigitalRenderer module.
  320. - Added screenshot functionality for saving sprites. The Unix version also allows
  321.   BMP and PNG but I figured we don't want BMP on RISC OS and we don't want about
  322.   100kB of libpng and libz linked into each emulator, so it's sprites only for us.
  323. - C64: files named "*/PRG" are now treated like ones with file type &64, i.e.
  324.   you can drag them into the emu window to load native C64 files.
  325.  
  326.  
  327.  
  328. RISC OS NEWS since 1.1
  329. ======================
  330.  
  331. Basically I kept the port in sync, i.e. added icons for new resources and so on.
  332. My main contribution to 1.2 was a restructuring of the drive emulation code which
  333. now uses shared code and private data sections for both drives. That cut about
  334. 150kB off each executable and made the true drive emulation a little faster on
  335. RISC processors.
  336.  
  337.  
  338.  
  339. RISC OS NEWS since 1.0.0.1
  340. ==========================
  341.  
  342. - Fixed bug concerning pause when the joystick window is open.
  343. - Optionally display status line in full screen mode (toggle with F9)
  344. - Support for multiple emulation windows; currently used by Vice128 (see below).
  345. - Support for keyboard configuration files (see below)
  346. - Message windows for License, Warranty and Contributors, available from icon
  347.   bar menu.
  348.  
  349.  
  350.  
  351.  
  352.  
  353. RISC OS NEWS since 0.16.1.0
  354. ===========================
  355.  
  356. - Sound code more stable.
  357. - Added freeze menu entry for modules like Action Replay.
  358. - ROMSet support via ROMSet Archives (see System window).
  359. - Imagecontents added: drag an image file (D64, T64, ...) to one of the drive
  360.   icons or the drive paths while holding down shift and instead of attaching the
  361.   image file a directory viewer will appear -- unless an error occurred. Also
  362.   since RISC OS doesn't allow more than one open on a file that has been opened
  363.   with write access you can't use this mechanism on an image that has already
  364.   been attached. Double-click on an item to load it into the emulated machine.
  365. - Option full screen mode operation (see below).
  366. - Lots of small bugs and features.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373. Overview:
  374. =========
  375.  
  376. 1) What is it?
  377.    Vice is a collection of emulators covering 5 CBM machines, the C64, the C128,
  378.    the VIC20, the PET series and the CBM2 series.
  379.  
  380. 2) Memory requirements: Huge.
  381.    It's not possible to run any of these emulators on a 4MB machine. It's an
  382.    extremely close shave on an 8MB machine if you can get around 5-6MB free,
  383.    depending on which emulator you want to run. You should have more.
  384.  
  385. 3) CPU requirements: Huge.
  386.    Vice is cycle-exact, so if you compare it to Frodo you have to compare it
  387.    to FrodoSC and relative to that Vice is very fast. That doesn't change the
  388.    fact that you won't have much fun running Vice if you don't have a StrongARM.
  389.  
  390. 4) Concluding:
  391.    Vice is only recommended on StrongARM RiscPCs with 16MB or more.
  392.  
  393.  
  394.  
  395.  
  396. Running Vice:
  397. =============
  398.  
  399. Just double-click on the Vice-machine's filer-icon and it will install an icon
  400. on the icon bar and open the emulation window. Make sure !ViceRsrc can be
  401. written to if you want to save your Vice settings. The settings for each
  402. emulator will be stored in !ViceRsrc.<machine-name>.vicerc.
  403.  
  404. IMPORTANT NOTE: Do not terminate any of the emulators by force using ALT BREAK
  405. or something similar while sound (meaning the VIDC sound device) is active.
  406. While this is no problem when (VIDC) sound emulation is off this will in all
  407. likelyhood kill another one of your applications if it's on.
  408.  
  409.  
  410.  
  411.  
  412. Troubleshooting:
  413. ================
  414.  
  415. If nothing happens after the double-click the reason is probably 1) not enough
  416. memory or 2) !ViceRsrc has been moved so Vice$Path, the central variable pointing
  417. to the shared resources for each emulator, is no longer valid. In that case just
  418. double-click on !ViceRsrc and all necessary information will be updated.
  419.  
  420. If one of the emulators (not an emulated program!) should crash with sound
  421. emulation enabled you'll keep hearing the last sample buffer and no other
  422. program can use sound anymore. To remedy that you have to issue ``*DRenderOff''
  423. at the CLI.
  424.  
  425.  
  426.  
  427.  
  428. Vice configuration:
  429. ===================
  430.  
  431. There are a sh**load of configurations for each Vice. Check the general docs
  432. for a description of what everything does. You won't need many of those in
  433. everyday use.
  434. A lot of the configurations are in the form of menus. I didn't put descriptive
  435. labels next to those menus since that'd take up too much space. If you want
  436. to know what a menu group does just open the menu and check the title. The
  437. only menus that need a little extra explanation are probably the ones consisting
  438. of menu icon + descriptive icon + value icon (e.g. ``DOS Name'' and ``Cartridge''
  439. in the System configuration window). In the case of ``DOS Name'' the menu
  440. selects the drive type whose ROM name should be displayed (and made editable)
  441. in the writable icon, in the case of ``Cartridge'' the menu selects the type
  442. of the cartridge file in the value icon.
  443. Most configurations take immediate effect. Changes to writable icons only take
  444. effect after pressing <Return>. Some changes only take effect when Vice is
  445. restarted or the configurations are reloaded, however. Among those are the
  446. names for the various system resources like ROMs or palette files, all of which
  447. are found in the Configure->System window.
  448.  
  449.  
  450.  
  451. RISC OS specifics:
  452. ==================
  453.  
  454. System and Video window:
  455. ------------------------
  456.  
  457. Auto Pause:    automatically pause the emulator when the emulator window is
  458.         closed.
  459. Poll cs:    Minimum number of centiseconds between polls. Increase the
  460.         value to make Vice faster but the desktop less responsive.
  461. Speed cs:    Evaluate the emulation speed with this frequency.
  462. Sound cs:    Poll the sound hardware with this frequency. This value should
  463.         always be smaller than the configured sound buffer size. Using
  464.         a value of 0 defaults to half the buffer size.
  465.  
  466. ROMsets:    These are handled via ROMset archives (*/vra). The menu to the
  467.         left lets you choose one of the ROMsets currently available,
  468.         the one to the right lets you edit them. Create: add the current
  469.         ROM configuration to the ROMsets (give it a name first). Delete:
  470.         delete the currently selected ROMset. Save: save the currently
  471.         selected ROMset (not all of them). Dump: save entire ROMset
  472.         archive as ``romset/vra'' to the current machine's folder in
  473.         !ViceRsrc. Clear: remove all ROMsets, emptying the archive.
  474.         Restore: reload the ``romset/vra''-File mentioned above.
  475.         You can add a romset archive file to your current archive by
  476.         dragging this file (named */vra) to the System & Video window.
  477.  
  478.  
  479.  
  480. Pane icons:
  481. -----------
  482.  
  483. At the top are the 4 icons for each of the possible 4 disk drives. Immediately
  484. below that (initially blank) is an icon that'll display the current halftrack
  485. for drive 8 or 9 when in True Drive Emulation mode. You can toggle the drive
  486. whose halftrack you want to see by clicking on this icon. Below that icon is
  487. the Pause/Resume icon which should be self-explanatory. The Reset-icon will
  488. reset the emulated machine; click with select for a soft reset, adjust for a
  489. hard reset (which will also clear memory). The icon at the bottom can be used
  490. for toggling the size of the emulation window.
  491. In contrast to other platforms the drive LEDs also work when not in True Drive
  492. Emulation mode.
  493.  
  494.  
  495.  
  496. Multiple emulator windows:
  497. --------------------------
  498.  
  499. You can have multiple emulator windows for a machine (ATM C128 only). In this
  500. case only one of the windows will have a pane attached to it (this is the
  501. ''active emulator window'') and you can use the pane to toggle its size. You
  502. can transfer the pane to another window by either pressing F10 or using the menu
  503. entry ``MovePane'' in the emulator menu. In full screen mode you can use F10 to
  504. select the emulation window you want to display.
  505. Opening & closing: clicking select on the icon bar icon will always affect
  506. the last active emulator window, i.e. the one with the pane will be either
  507. opened or raised. You can open the other emulator windows by moving the pane
  508. (i.e. F10 or menu).
  509. Note: the 40/80 key of a C128's keyboard is ``emulated'' in the C128 config
  510. window.
  511.  
  512.  
  513.  
  514.  
  515.  
  516. Data IO:
  517. ========
  518.  
  519. On RISC OS we use drag and drop, so forget all references to file selection
  520. dialogue boxes and similar bullshit.
  521.  
  522. Attaching disk images / directories to drives:
  523. Drag the directory or disk image icon to the drive's LED on the EmuWindow's
  524. pane or the corresponding writable path icon in the Configure->Drives window.
  525. Disk images should be typed &164 (D64Image). If everything went well the
  526. writable path icon will be updated to show the new path afterwards, otherwise
  527. it'll remain unchanged (for instance when trying to attach a disk image to a
  528. drive that has drive type ``none'').
  529.  
  530. Selecting the files for RS232/Printer/Sound devices:
  531. The groups {OK-Button, writable path icon, draggable sprite} in the corresponding
  532. Configuration windows behave like in a Save As box.
  533.  
  534. Saving snapshots:
  535. Open snapshot savebox via the emulator window's menu. From then on it's exactly
  536. like a standard savebox. Note that when making a snapshot the emulator will
  537. run for a little more until it's ready. So even though you've got the emulator
  538. paused it'll progress a little -- this can't be helped.
  539.  
  540. Loading snapshots:
  541. Drag snapshot file icon to EmuWindow. The file must be typed ``Data'' (which
  542. it is by default) and of course be for the correct (virtual) machine.
  543.  
  544. Loading files directly into Vice64:
  545. Files typed &64 are interpreted as raw C64 files with the load-address in the
  546. first two bytes. These files can be loaded into Vice64 (not the other Vices!)
  547. by dragging them to the emulation window. This has the same effect as if you
  548. had loaded the file using ``LOAD "file",8,1'' from the emulator, except it's
  549. a lot faster and you don't have to worry about overwriting the IO area at
  550. $D000 for long files.
  551.  
  552.  
  553. Joystick configurations:
  554. ------------------------
  555.  
  556. Each joystick port can be mapped to 5 ``devices'': None (inactive), two sets
  557. of keys for emulation or two real (Acorn-compatible) joysticks. You can edit
  558. the keys thus: 1) make sure the Joystick-configuration window has the input
  559. focus by clicking inside it. 2) place the mouse pointer over the icon for
  560. the direction you wish to change and press the key you want to map to this
  561. direction. You may have to hold the key depressed for a while before it's
  562. recognized. You can also use keys like shift/ctrl/alt here.
  563.  
  564.  
  565. Keyboard shortcuts:
  566. -------------------
  567.  
  568. F5:   Toggle sound
  569. F6:   Activate monitor
  570. F7:   Restore-key (usually only has effect in combination with RUN/STOP=Escape)
  571. F8:   Reset emulator
  572. F9:   Toggle emu pane
  573. F10:  move pane to next emulation window (has effect on C128 only)
  574. F12:  (when in full screen mode) Return to desktop
  575. Print: Save screenshot to same path as last one (doesn't work for 1st save)
  576. ^F9:   Save snapshot to same path as last one (ditto)
  577. ^F10:  Load snapshot from last path (ditto)
  578. num/: Toggle True Drive Emulation. This will grey out drive icons 10 and 11.
  579. Copy: Toggle pause
  580. ScrollLock: When active, Vice goes into single tasking mode. This is 1) a
  581.       bit faster and 2) ensures continuous sound playback.
  582.  
  583.  
  584. Languages:
  585. ----------
  586.  
  587. The frontend is language-independent. All you have to do is provide a
  588. file containing the label --> text translations and set up the variable
  589. <Vice$Messages> to point to this file before startup. The english version
  590. can be found at Vice:Messages.
  591. This doesn't affect messages generated by the cross-platform Vice code itself,
  592. however, which will remain english. You'll have to complain to the Vice core
  593. team if you want that changed ;-).
  594.  
  595.  
  596.  
  597. Full Screen Mode:
  598. -----------------
  599.  
  600. You can now also run Vice in full screen mode, i.e. single tasking outside
  601. the WIMP environment. You can enter full screen mode using the icon bar
  602. menu and leave it again by pressing F12.
  603. The screen mode to use is very dependent on your computer and the machine
  604. emulated by Vice; therefore the mode is user-definable. The screen mode is
  605. described by a string of the form ``mode:resx,resy,lddepth'' (no spaces;
  606. lddepth is log2 of the depth, i.e. 2 for 4bpp, 3 for 8bpp, 4 for 16bpp, ...),
  607. to accomodate both new and old style mode selection. If you're running
  608. Vice on a RiscPC the second part of the mode descriptor string (resx,resy,lddepth)
  609. will be used, otherwise it's the mode number. By default ``28:640,480,3''
  610. is used because it's a standard mode and big enough to display all emulators;
  611. but it's certainly not ideal for all emulators, so have a play yourself.
  612. Also, if ``SetPalette'' is configured on, the screen mode has <= 8bpp and
  613. can display enough colours for the emulated machine, the palette will be
  614. reprogrammed, so when using a 4bpp mode with !Vice64 you'll get exact colours.
  615. Depth issues: internally Vice uses 8bpp for the display. On older machines
  616. it'll be more efficient to use an 8bpp mode because it minimizes computational
  617. overhead. On a StrongARM RiscPC, OTOH, you'll be better off using a mode with
  618. less colours (e.g. 4bpp for !Vice64) because that'll require less bandwidth.
  619. Since the palette can be reprogrammed there's no reason whatsoever to use
  620. a mode with more than 8bpp unless you think Vice is running too fast.
  621. You can edit the full screen mode string in the system configuration window.
  622. As far as configurations in full screen mode go: there are none. Neither can
  623. you attach any images and so on, only the keyboard-shortcuts still work. And
  624. I definitely won't re-program all the stuff that's available in the multi-
  625. tasking version for the fullscreen version.
  626.  
  627.  
  628.  
  629.  
  630.  
  631. Keyboard configuration files:
  632. -----------------------------
  633.  
  634. This is a new feature (wasn't available on RISC OS in Vice 1.0.0.1 yet). It
  635. allows you to change the keyboard mapping from your RISC OS computer to the
  636. keys of the emulated machine. The files used by the Unix-Version of Vice
  637. are unusable for this, therefore I made a new format. The RISC OS keyboard
  638. mapping files have the name RO*/vkm in the corresponding machine's sub-
  639. directory in !ViceRsrc (e.g. !ViceRsrc.C64.ROdflt/vkm). You have to edit
  640. these files (it says they're for RISC OS in the first line), not the ones
  641. for Unix.
  642. Hacking these files is quite low-level and thus not for the faint-hearted.
  643. On the RISC OS side you have to deal with _internal_ key-numbers which
  644. have nothing to do with ASCII. On the emulated machine's side these keys
  645. have to be mapped to row/column indices (see the Vice documentation for
  646. keyboard layouts).
  647. A line of this file has the format
  648.  
  649. intkey row col [s [srow scol [s]]] ["keystr"]
  650.  
  651. - intkey is the internal key number.
  652. - row, col are the row and column of the keyboard matrix of the emulated
  653.   machine. Use 15 for both to disable the key.
  654. - if row/col are followed by an 's' this means that a pressed shift-key
  655.   should also be emulated (e.g. for cursor left which is shift+cursor right
  656.   on a real C64).
  657. - if this is followed by another pair of numbers these are interpreted as
  658.   mappings for this key if the shift key is pressed.
  659. - at the end of each line is an optional string-representation of this key
  660.   in double quotes (valid for an english keyboard).
  661.  
  662. The mapping for shifted keys will probably need additional explanation:
  663. you DON'T have to (and shouldn't) define anything here if it's a trivial
  664. shifting, e.g. a+shift --> a+shift (the default keyboard mappings don't
  665. have any shifted mappings defined!). It should be used if the shifted key
  666. doesn't obey the mapping <base key> + shift --> <base key> + shift, e.g.
  667. mapping the asterisk (shift + '8' on an english keyboard) to the asterisk
  668. on a C64 (an unshifted key which is located where the ']' is on an english
  669. keyboard). For this example the mapping of the key '8' (internal key number
  670. 21) for a C64 would look like this:
  671.  
  672. 21 3 3 6 1
  673.  
  674. As a general rule of thumb: don't screw around with this file and make a
  675. backup copy before you do. It should also be noted that the more entries
  676. you define in the shifted keymap and the more 's'-flags you use the more
  677. likely problems arise (especially for games where a faithful mapping might
  678. be required). Imagine for instance a program that uses shift and '*' for
  679. two operations and you mapped the RISC OS '*' ( = shift + '8') to the '*'.
  680. You could never use both operations at the same time which can be a real
  681. nuisance if e.g. one of those operations is ``run'' and the other is
  682. ``fire''. You should therefore always strife to minimize both shifted
  683. keymaps and 's'-flags. The default mappings don't define any shifted keymaps
  684. and only 3 's'-flags, for instance. Also take care that you don't use keys
  685. that have a special meaning for Vice, e.g. F5-F10 etc.
  686. It's a dirty job but at some point I had to to it... ;-).
  687.  
  688. I didn't bother to make the filenames configurable; they're ROdflt/vkm
  689. for all emulators except for PET where they're RObusi/vkm (for business
  690. layout) and ROgrph/vkm (for graphic layout). Deleting these files will
  691. run Vice with the default keymap. You can load a keymap at run-time by
  692. dragging the file to the Kbd-icons in the System configuration window.
  693. One of these icons also opens a menu from where you can save the currently
  694. active keyboard mappings to a file.
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702. Misc:
  703. -----
  704.  
  705. - When turning on true drive emulation or dealing with snapshots, sound is
  706.   suspended for a short time. This is not a bug, it has to be done.
  707. - The default sound buffer size of 0.35s is only recommended when playing
  708.   music. If you're doing anything interactive you should use a lower value,
  709.   no higher than 0.1s.
  710. - Attaching compressed images (disk/ROM/...) is not supported on RISC OS.
  711.   Well, we have image filing systems for that.
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718. Support Programs:
  719. =================
  720.  
  721. c1541 and petcat are inside the !ViceRsrc directory and can be run using
  722. vice:c1541 / vice:petcat. For a description of both check the general Vice
  723. documentation. I didn't provide hacks to run either from one of the emulators,
  724. though.
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732. Thanks:
  733. =======
  734.  
  735. - Richard Atterer (atterer@informatik.tu-muenchen.de) for creating a set of
  736.   very nice looking icons.
  737.  
  738. - Stefan Bellon (sbellon@sbellon.de) for repeatedly compiling the CPU-files
  739.   with optimization for me back when I only had an A5000 at my disposal
  740.   (some of those need over 40MB).
  741.  
  742. - Richard Atterer, Stefan Bellon, Michael Kübel (Kuemmel@studbox.uni-stuttgart.de)
  743.   and Erhard Furtner (Erhard.Furtner@sbg.ac.at) for beta-testing.
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750. Ported by:
  751. ==========
  752.  
  753. Andreas Dehmel
  754. zarquon@t-online.de
  755. http://home.t-online.de/~zarquon
  756.